Remove the AI Brand Insights modals from the Yoast SEO installation by JorPV · Pull Request #23439 · Yoast/wordpress-seo

JorPV · 2026-07-09T09:12:32Z

Context

This disables the the "Discover Brand Insights now" modal.

Summary

This PR can be summarized in the following changelog entry:

Removes the "Discover Brand Insights now" and "Your first brand analysis is free!" modals that were shown after installing Yoast SEO.

Relevant technical choices:

Same pattern as the already-disabled pre-launch modal: both AI_Brand_Insights_Post_Launch::should_show() (Free) and AI_Brand_Insights_Free_Trial::should_show() (Premium) now return false (methods marked @codeCoverageIgnore), mirroring AI_Brand_Insights_Pre_Launch.
Both introductions are unregistered from the JS initialize.js component map, their now-obsolete unit tests are removed, and the now-unused modal component files are deleted (including the already-disabled ai-brand-insights-pre-launch, so no dead component files remain).
The PHP introduction classes are removed and not deprecated, low impact.

Test instructions

Test instructions for the acceptance test before the PR gets merged

This PR can be acceptance tested by following these steps:

Reset the introductions "seen" state so the modal can show. Reset via the database / WP-CLI (or use a brand-new admin user):

WP-CLI: wp user meta delete <admin-login> _yoast_wpseo_introductions
- On plugin-development-docker, run this via the wrapper script instead: docker exec basic-wordpress wp user meta delete admin _yoast_wpseo_introductions
or SQL: DELETE FROM wp_usermeta WHERE meta_key = '_yoast_wpseo_introductions' AND user_id = <admin-id>;

This affects two modals: "Discover Brand Insights now" (Free, no Premium subscription) and "Your first brand analysis is free!" (Premium). Test each on the matching setup.

First, on trunk (before this change):

After the reset above, go to a Yoast SEO admin page (e.g. Yoast SEO → General).
On a Free site, confirm the "Discover Brand Insights now" modal does appear.
On a Premium site, confirm the "Your first brand analysis is free!" modal does appear.

Then, on this branch:

Check out this branch and rebuild the assets (grunt build:dev).
Reset the "seen" state again (as above).
Reload the Yoast SEO admin page and confirm neither modal appears (Free: "Discover Brand Insights now"; Premium: "Your first brand analysis is free!").
Instead you should see the Schema aggregation modal

Confirm other introductions still behave normally (nothing else regressed).

Relevant test scenarios

Changes should be tested with the browser console open
Changes should be tested on different posts/pages/taxonomies/custom post types/custom taxonomies
Changes should be tested on different editors (Default Block/Gutenberg/Classic/Elementor/other)
Changes should be tested on different browsers
Changes should be tested on multisite

Test instructions for QA when the code is in the RC

QA should use the same steps as above.

Impact check

This PR affects the following parts of the plugin, which may require extra testing:

The introductions/announcements shown on Yoast SEO admin pages (the AI Brand Insights post-launch and free-trial modals are affected).

Other environments

This PR also affects Shopify. I have added a changelog entry starting with [shopify-seo], added test instructions for Shopify and attached the Shopify label to this PR.
This PR also affects Yoast SEO for Google Docs. I have added a changelog entry starting with [yoast-doc-extension], added test instructions for Yoast SEO for Google Docs and attached the Google Docs Add-on label to this PR.

Documentation

I have written documentation for this change. For example, comments in the Relevant technical choices, comments in the code, documentation on Confluence / shared Google Drive / Yoast developer portal, or other.

Quality assurance

I have tested this code to the best of my abilities.
During testing, I had activated all plugins that Yoast SEO provides integrations for.
I have added unit tests to verify the code works as intended.
If any part of the code is behind a feature flag, my test instructions also cover cases where the feature flag is switched off.
I have written this PR in accordance with my team's definition of done.
I have checked that the base branch is correctly set.
I have run grunt build:images and committed the results, if my PR introduces or edits images or SVGs.

Innovation

No innovation project is applicable for this PR.

Fixes #23431

…te introduction logic to prevent display on fresh sites.

Copilot

Pull request overview

This PR disables the “Discover Brand Insights now” post-install introduction modal in Yoast SEO to improve the first-run experience on fresh sites, and avoids UI competition with upcoming onboarding flows.

Changes:

Disables the PHP introduction by making AI_Brand_Insights_Post_Launch::should_show() always return false (and marks related methods as @codeCoverageIgnore).
Unregisters the introduction’s JS modal component from the introductions component map.
Removes the now-obsolete unit test for the post-launch introduction.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
`tests/Unit/Introductions/Application/AI_Brand_Insights_Post_Launch_Test.php`	Removes unit tests that are no longer applicable after disabling the introduction.
`src/introductions/application/ai-brand-insights-post-launch.php`	Permanently disables the post-launch introduction via `should_show(): false` and annotates methods for coverage exclusion.
`packages/js/src/introductions/initialize.js`	Removes the post-launch modal from the JS `initialComponents` map so it can’t be rendered client-side.

JorPV · 2026-07-09T09:33:11Z

 	const initialComponents = {
 		"ai-brand-insights-free-trial": AiBrandInsightsFreeTrial,
-		"ai-brand-insights-post-launch": AiBrandInsightsPostLaunch,
 		"black-friday-announcement": BlackFridayAnnouncement,
 		"delayed-premium-upsell": DelayedPremiumUpsell,
 		"schema-aggregator-announcement": SchemaAggregatorAnnouncement,


Keeping it for consistency with the already-disabled ai-brand-insights-pre-launch.js, which is likewise left in place (unreferenced) while its introduction is off. Makes re-enabling trivial and keeps the two AIBI modals symmetric.

Updated: we've now deleted the unused component files (post-launch, free-trial, and the already-disabled pre-launch) as you suggested. The PHP introduction classes are intentionally kept (should_show() => false) so their ids stay registered for the /introductions/{id}/seen route — removing a class, unlike the dead view files, could break a Premium version that interacts with the introductions system (thread 🧵) .

Disables the Premium "Your first brand analysis is free!" modal the same way as the post-launch modal, per the UX follow-up on the issue. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Delete the now-unreferenced post-launch and free-trial modal component files (per PR review). The PHP introduction classes are kept (should_show() => false) so their ids stay registered in the collector and the introductions "seen" REST route keeps validating them — this avoids breaking any Premium version that interacts with the introductions system. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Delete the already-disabled pre-launch modal component too, so no dead disabled-modal component files remain. Its PHP introduction class is kept (should_show() => false), matching the post-launch and free-trial handling. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated no new comments.

coveralls · 2026-07-09T10:19:53Z

Coverage Report for CI Build 0

Warning

Build has drifted: This PR's base is out of sync with its target branch, so coverage data may include unrelated changes.
Quick fix: rebase this PR. Learn more →

Warning

No base build found for commit 2ee4dc7 on trunk.
Coverage changes can't be calculated without a base build.
If a base build is processing, this comment will update automatically when it completes.

Coverage: 46.425%

Details

Patch coverage: No coverable lines changed in this PR.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

Requires a base build to compare against. How to fix this →

Coverage Stats


Relevant Lines:	62195
Covered Lines:	30246
Line Coverage:	48.63%
Relevant Branches:	12205
Covered Branches:	4294
Branch Coverage:	35.18%
Branches in Coverage %:	Yes
Coverage Strength:	8.0 hits per line

💛 - Coveralls

…ove-brand-insights-modal

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

thijsoo · 2026-07-24T07:53:33Z

+	 *
 	 * @return string The ID.
 	 */
 	public function get_id() {


should these files not be moved to the deprecated folder?

Actually I've checked across Premium: trunk, and older zips to be 'sure' and found zero references to ai-brand-insights-free-trial/ai-brand-insights-post-launch (or their class/component names) anywhere, PHP or compiled JS. Since these aren't public API and nothing in Premium depends on the ids, i think it's safe to remove the two classes outright instead of moving them to src/deprecated/(thread 🧵).

Removing the ids just makes the "seen" call a clean no-op 400 instead of succeeding. No plugin break.

Their should_show() already returns false and the JS modal components were already removed. Verified against Premium's trunk, 28.1/28.2-RC1, and the shipped 27.6/27.9 release zips that nothing references these ids or class names, so keeping them around is unnecessary. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

vraja-pro

CR & AC ✅

Removes the AI Brand Insights modals/classes/tests and image that #23439 deleted from trunk, plus stray wordpress-urls (class-wpseo-utils) and yarn.lock edits, so this PR only contains the guided-tour work. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Remove AI Brand Insights Post Launch modal and associated tests; upda…

06a9d34

…te introduction logic to prevent display on fresh sites.

JorPV added changelog: enhancement Needs to be included in the 'Enhancements' category in the changelog and removed changelog: enhancement Needs to be included in the 'Enhancements' category in the changelog labels Jul 9, 2026

JorPV requested a review from Copilot July 9, 2026 09:20

Copilot started reviewing on behalf of JorPV July 9, 2026 09:21 View session

JorPV added the changelog: other Needs to be included in the 'Other' category in the changelog label Jul 9, 2026

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Remove AI Brand Insights free-trial modal after installation

402d31c

Disables the Premium "Your first brand analysis is free!" modal the same way as the post-launch modal, per the UX follow-up on the issue. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

JorPV changed the title ~~Remove the 'Discover Brand Insights now' modal from the Yoast SEO installation~~ Remove the AI Brand Insights modals from the Yoast SEO installation Jul 9, 2026

JorPV and others added 2 commits July 9, 2026 11:52

JorPV requested a review from Copilot July 9, 2026 10:07

Copilot started reviewing on behalf of JorPV July 9, 2026 10:12 View session

Copilot AI reviewed Jul 9, 2026

View reviewed changes

JorPV added 2 commits July 21, 2026 15:51

Merge branch 'trunk' of github.com:Yoast/wordpress-seo into 23431-rem…

3ea8a72

…ove-brand-insights-modal

Remove unused image file: ai-brand-insights-pre-launch.jpg

257c623

JorPV requested a review from Copilot July 23, 2026 08:12

Copilot started reviewing on behalf of JorPV July 23, 2026 08:13 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread src/introductions/application/ai-brand-insights-post-launch.php Outdated

Comment thread src/introductions/application/ai-brand-insights-free-trial.php Outdated

JorPV added 2 commits July 23, 2026 10:19

Update messages

cdc9e6b

Update comment for clarity

f5cb7cd

thijsoo reviewed Jul 24, 2026

View reviewed changes

vraja-pro added changelog: non-user-facing Needs to be included in the 'Non-userfacing' category in the changelog and removed changelog: other Needs to be included in the 'Other' category in the changelog labels Jul 27, 2026

vraja-pro approved these changes Jul 27, 2026

View reviewed changes

vraja-pro added this to the 28.3 milestone Jul 27, 2026

vraja-pro merged commit 0d64c67 into trunk Jul 27, 2026
50 checks passed

vraja-pro deleted the 23431-remove-brand-insights-modal branch July 27, 2026 08:37

Navigation Menu

Uh oh!

Remove the AI Brand Insights modals from the Yoast SEO installation - #23439

Remove the AI Brand Insights modals from the Yoast SEO installation#23439
vraja-pro merged 9 commits into
trunkfrom
23431-remove-brand-insights-modal

JorPV commented Jul 9, 2026 •

edited by vraja-pro

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

JorPV Jul 9, 2026

Uh oh!

JorPV Jul 9, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

coveralls commented Jul 9, 2026 •

edited by coveralls-official Bot

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

thijsoo Jul 24, 2026

Uh oh!

JorPV Jul 24, 2026 •

edited

Loading

Uh oh!

vraja-pro left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

JorPV commented Jul 9, 2026 • edited by vraja-pro Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Context

Summary

Relevant technical choices:

Test instructions

Test instructions for the acceptance test before the PR gets merged

Relevant test scenarios

Test instructions for QA when the code is in the RC

Impact check

Other environments

Documentation

Quality assurance

Innovation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

JorPV Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

JorPV Jul 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

coveralls commented Jul 9, 2026 • edited by coveralls-official Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage Report for CI Build 0

Coverage: 46.425%

Details

Uncovered Changes

Coverage Regressions

Coverage Stats

💛 - Coveralls

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

thijsoo Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

JorPV Jul 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vraja-pro left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

JorPV commented Jul 9, 2026 •

edited by vraja-pro

Loading

JorPV Jul 9, 2026 •

edited

Loading

coveralls commented Jul 9, 2026 •

edited by coveralls-official Bot

Loading

JorPV Jul 24, 2026 •

edited

Loading